Locator Property

The following table describes the syntax supported by the Locator property:

Syntax

Arguments

 
[provider://]pathinfo[?param=value[;param=value]…n]

provider: This is a type of persistence storage. Use erwin to specify file system, and use mart for a mart. If this is skipped, erwin is the default.

pathinfo: This is the path to the storage location, which is either a file path or the mart path.

param: This is either a parameter name or a keyword.

value: This is a text string.

There are no param keywords defined for the file system persistence storage.

A list of Locator param keywords for use with the mart type of provider for models stored in a mart is described in the following table.

There is a special arrangement for the erwin� Data Modeler Workgroup Edition Locator. Part of the Locator string with params can be omitted if an application has connections open with one or more mart repositories. In this case, the params part of the Locator string can have only partial information or not be present at all, as long as it is clear to which connection from the available list it refers.

Currently, erwin� Data Modeler Workgroup Edition allows only one open connection to a mart repository at any given time. Therefore, it is possible, after establishing a connection, to omit the params part of the Locator string completely and to provide the model path information only.

The following table provides a list of Locator param keywords for use with the mart type of provider for models stored in a mart:

Complete Name

Abbreviation

Description

Server

SRV

Location where the application server exists.

Trusted Connection

TRC

This is an optional parameter. When set to YES--it instructs to use the Windows authentication model for login validation. When set to No or when the value is not mentioned--it instructs to use username and password to log in, in which case the UID and PSW keywords must be specified.

Version Number

VNO

Version number of the model.

User

UID

Login user name. Do not specify UID when using Windows Authentication.

Password

PSW

User login password. Do not specify PSW if you use Windows Authentication (Trusted Connection set to YES).

Port Number

PRT

Port number to which the application server listens.

Application Name

ASR

Name of the application server.

The following table describes various scenarios in which you can use the Locator param keyword along with the mart type of provider for models stored in a mart:

Scenario

Description

erwin� Data Modeler Workgroup Edition

Your Libraries/ Models are stored in the Mart under the catalog named �Mart�. Mart is the default name, you can change it. A library can contain a library. If a library that is specified in path does not exist in the Mart, the library is created at the time of saving the model and the model is stored in that library.

If you have a model named MyModel located in MyLib, which is in an SSL secured Mart, you can use the following:

mart://<CatlogName>/<Libraryname>/<ModelMName>?VNO=<versionno>;TRC=NO;SRV=<ServerLocation>;PRT=<portno>;ASR=<ApplicationServerName>;SSL=<YES/NO>;UID= <user id>;PSW=<password>

For example:

mart://Mart/MyLib/MyModel?VNO=1;TRC=NO;SRV=<ServerLocation>;PRT=<portno>;ASR=<ApplicationServerName>;SSL=<YES>;UID= <user id>;PSW=<password>

Local drive

If you have a model called mod.erwin located in the models directory on the C drive, you can use the following:

C:\models\mod.erwin